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Ibis Memo, describes a version of DDT used as Che command level of 
the A.I. Group PDP-6 Time Sharing System (ITS). Special features include 
capability to handle multiple Jobs, ability to stop or read or write 
references to a given location, and the ability of system programs to 
return ccrrniand. strings to be executed by the DDT, 
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General features : 



This DOT allows start up and debugging of several distinct 
pro#ra« at the sane time. In any system of this sort, means must 
be provided to switch rapidly between programs and yet at the 
same tine maintain the distinction between the states (running, 
stopped, etc*), the syabols, and the cere ii&^es of the prosraas, 

Tb achieve this distinction, several features are 
provided* The job$ J command switches between Jote, preserving 
the state of the old job and restoring the state of the new one* 
If the programs being worked on are running at the same tiae 
they are being detuned, there is the possibility of the proprao 
mnnlre into trouble. In this case, the DOT does not wish 
to type a wssage out to you, since you are very likely 
doing work on this or another program which should not he 
interrupted* Dhder these circumstances, BET types a "bell, 
indicating that some job in softe way wants attention* Yhen the 
user wishes, he aay then type $J at his convenience, and the JUT will 
respond with the program name, the reason for the break, etc* In this 
way it is possible to control more than one prograu at once without 
worry ing about what effect one program will have on another* 

Commands: 

SA or $$A sets absolute addressing mode [temporary or permanent). 

syn£S sets breakpoint at location "$/**" Up to ? "breakpoints 

may be specified, A particular breakpoint may be set Iff symSnB, 

where n is the desired breakpoint. When the program executes the 

breakpoint, the DOT types out "prograa c*unter»$nB ," 

O&nB removes breakpoint n. 

$1 removes all breakpoints. 

symdocJInE inserts a breakpoint at location sym and types out 

the contents of register loc when the breakpoint is encountered. 

SC or £$C sets constant mode (numbers In current radix) 

$D or f$E sets decimal type out nde 

symSS searches current prograi for locations with effective 
address of "sya". 

Iocl<loc2>syjo$l searches for such locations between loci and loc2. 
sets , and the rin* buffer of . to addresses found, 

SF or $$F sets type out mode to floating point. 

fG or sym$G starts the program at the current starting location or at location sym. 
synilSG sets starting address to sym and starts at sym, 

$3B is the teeudo- location where the starting address is stored, 

$Hor S$H sets type out mode to half words (instead of instructions in the left half), 
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loc«n$I sets memory address register to location loc f with 
n In the break register. Useful rallies of n are; 
6 causes a program interrupt on read or write cycles of location loc 
? causes an Interrupt on write cycles only, jfcte that eon* test 
instructions such as SKIFE do write cycles, 
DOT types out MiR.addr>»instruction when the condition Is net. 
The Instruction printed may be oae after the instruction causing the 
Interrupt* 

name $ J set current job to naae* 

create Job name if no such Job exists. Creation of new Job types ! 

$J set current job to one that needs attentionUn response to a hell that Ms teen 

typed.), types out the Job name followed ty the reason it needs 
attention* 

RBCe$$J set current job's naae to name. 

syo$K half kill symbol sym In the current job's symbol table, 
(DPT will no longer type it out,) 

$ym&K fully kill the symbol eym—will no longer 
be accepted for input, 

$$X kill all symbols of the current pre-eram, 

|L nl n2 user;dev^ 

or 

deTSl nl n2 user^p 

load file nl n2 from deTice dev under user name user into the current 

Job's core imafie, Zeroes the core, kills the symbol table t 

and closes 10 channels before loading. 

DDT remembers the name of the last file loaded or dumped, 

and uses it for unspecified arguments of the current command. 

All EFT'S Inserted remain. 

SSL as $L tat does not zero core, till symbols, or close 10 channels. 

n$H set mask for word searches to n 

vord$N search for a nemory loc not equal to word {in the area not masked off 
rjy the word mask) 

type out such locations* In the current mode, 
stops typii* out locations if any character is typed, 

locl*loc2>word$n searches between loci and loc 2 

30 or S$0 set type out Bode to octal 

$P proceed from last breakpoint or interruption and assign tty 

to this Job. n$F proceeds n times from this 
breakpoint before typing a EPT message* 

t$P proceeds indefinitely., typing & 1PT message each time the 
BPT is encountered 
typing any character during an indefinite proceed will stop it. 
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$Q last quantity typed \p either DOT or this user 

$$R set relocatable address mode. 

n$H or n$$H set current type out radix to n 

input radii is always 8. (or 10. for numbers terminated ty J 

$S or $$S set type out node to symbolic (nerval mode) 

n$T or nSST set type out In tytes of size n 

naae$U Logs in user* necessary before loading programs* 

types out and deletes file STSs name MAIL if it exists, 

$U loads new copy of DIT* destroys all inferior procedures, 

t$D logs out user (kills Jobs, deas signs all deTlces etc J 

SIV lists jobs that DDT knows about* along with the state: 

P => proceedable (interrupt) 
H r> running 
- => Just loaded 
nB=> broken on bpt n, 

* beside the current Job, system index follows. 

word$W searches for locations equal to word in portions not aasked ty 
the search Bask, type out and effect on * as in $H» 

ins$X executes instruction ins in the current job's core iaage. 
not usable if the Job is running* 
types 2 c,r,*s if ins does not skip, 3 if it does. 

IT as $L but dumps Instead of loads 

$$Z zeroes core of this Job, 

locl<loc2$$Z zeroes between loci and loc2, 

IA 

IB turn on line printer outnat from LET 

IC half kill the last symbol typed out and retype the last quanity 

ID 

IE turn off line printer outjut 

n|F list files on tape n 

deylr list files on device dev 

n$$lF flap tape n 
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|G full quit" to l>e used only when DOT hangs up completely, 

not to be used to stop type out, 

namelH load and start system programs — equivalent to 

name$J 

$L TS name SYS» 
$G 

types 1 If a new Job was created, J>**5 /v** /«^ Egjufak. 

$$| K disowns current procedure* 

IN 

|0 delete file—same format as $L 

|F proceed from the last "break or Interrupt without 

giving the teletype to the program. Allows the start up of several 
programs or the examination and change of running programs, 

*"> IQ «> t 

II 

IS silences type out (empties type out buffer) 

na&e|S set user name for inferior procedure 

JLIOlT dev: nl n£ dev; n3 n4p 

enter information into the device translation table. 

a-atoaic entry not further translated 

o-output only 

1- Input only 

translates opens for the first mentioned file to the second file* 

* in the first entries indicate any file. In the second, specify 

the same name as in the first, 

trailing arguments are assumed * p lack of leading A v J.or 

implies I<0» 

|U untranslated-same format as |T* 

I V turn on tty output 

|V turn off tty output 

a tX stops current procedure from running, types PC and instruction 

where it stopped, 

£|X destroys current Job. acquires a period typed following to 
have effect. 

$$|X destroys all Jobs of this DOT, requires period. 
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n|Y flush current symtol table and load new one using a us an AOBJtt 

pointer to user core* 

1 2 system wide quit character* when DET is the superior procedure 

to a program* JZ acts as if a breakpoint were encountered at the current 
PC. TJrping IZ on a console that is not in use loads a 

copy of CUT for use ty the user* 

9 =2000COOC, the indirect Mt C *>*'* w» ***** 

loc! open register, suppress type-out of contents. 
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type last auanity in sixfcit or ascii depending on 
whether S6* or t?" was last performed. 



15 symbol constituent 

$(doll&r si^n) syabol constituent 

Integer divide 
&. type last quanity as squoze symbol 

(quantity) has value of quantity with right and left fcfclves interchained* 

sya: defines symbol sym as equal to the currently open location* 

value*sym; define symbol sym as equal to value. 

sya$: sets program nane to sy» {used for relocatable programs) 

* integer nrultlply 

minus 

+ full word plus 

u truncate following symbols to right 18 hits and add 

s retype last quantity as current radix number 

2 close open register, deposit if register chained, 

close out tenporary changes in typ* out node* 

"* $& opens last register in , ring tuffer* 

4 close open register, and open neit sequential one, 

*4 as ^> t but regis teH-i 

f close open register, open previous one. 
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$f as Jp tut regis ter-1 

rubout erase last portion of a command or of new contents of a register, 

« symbol constituent, or declnal pt. in decimal or floating pt. numbers, 

ftr Itself f has the value of the currently open register. 

f separate AC field from address in normal instruction type iru 

M separate left and right halves of word in half word type in* 

/ type out contents of last address typed, and open the register. 

? list undefined syibols 

retype last quanity symbolically 

I as / hut types out constants 

] as / hat types out symbolically 

$6Hext(c.rJ treated as sixbit /text/ 

$71! text! treated as ascii ttext! t r> any character not in text 

< or > separators of arguments to other cow&nds 

$6" or S?" set type out mode to sixMt and ascii characters respectively* 

n$* or n$» takes no n- zero fields 

of n and has value of $Q with those fields replaced by the new values. 

\ open register addressed by $Q but do not change , 

$\ has value of the contents of the address of $Q 

~+ open register addressed ty $Q and change „ 

$ — * open register addressed ty left half of $Q and change * 

# typed after a previously undefined syabol, allows Halted "automatic assembly* 



Special feeudo- locations 

.PC prograa counter for current Jo to* 

,MASX interrupt mask for current Job, 

• STOP stop bits of this Job, 

.PIBQC PI requests waiting for this Jot, 

• IFIR as .PIPJ^C but IDE's word deposited Into register, 

■APIS as ,PIRQC but AKDCAM's word deposited into reels ter. 

• PICLR => PI in progress 

-1 => PI cleared. 

,HB(T top of user menory. 

*MAR address and bits set in MAR 

■■N .HAHPC last PC where MAS stopped program. 

.IOC +n is contents of 10 channel o 

• 105 +n is contents of 10 status word for channel n 
.IOP +& is contents of 10 pdl word n 



last Minute Changes (as of 1/5/6B) 

|K does not load symbols, 

S| a as iHtait load symbols. Without argument, loads symbols 

fron last program iH'ed, 

$; accepts arguments like $L and replaces symbol table of 

current Job with the symbol tatole of the specified file, 

$$; as S; but adds to current symbol table P 

IT aow adds to symbol table* $|T replaces table. 

$$J0 commands like $U takes file nane and executes DDT 

commands froi that file. 



